/**
 * @(#)ValorConfigurado.java 18/11/2010
 *
 * Copyright (c) 2007-2012 PsiqueWare S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information of PsiqueWare S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : AngelElectrico
 * <br/>Creaci&oacute;n: 18/11/2010 - 07:36:45 PM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>18/11/2010 | <a href = "mailto:AngelElectrico@PsiqueWare.com">&Aacute;ngel El&eacute;ctrico</a> | Creaci&oacute;n del Objeto.</li>
 *
 * </ul>
 */

package com.psiqueware.alheli.configuracion.basedatos.dao;

import com.psiqueware.alheli.configuracion.basedatos.ValorConfigurado;
import com.psiqueware.alheli.dao.BaseDAO;
import com.psiqueware.alheli.dao.DAOException;
import com.psiqueware.alheli.dao.EnlaceTransaccional;

import java.util.List;

/**
 * Contrato de operaciones CRUD para el objeto ValorConfigurado.
 * <br/>Paquete Original: com.psiqueware.alheli.configuracion.basedatos.dao
 * <br/>Nombre  Original: ValorConfiguradoDAO
 * <br/><a href="ValorConfiguradoDAO.java.html"><i>Ver C&oacute;digo Fuente</i> </a>
 *
 * @author <a href = "mailto:AngelElectrico@PsiqueWare.com">&Aacute;ngel El&eacute;ctrico</a>
 * @version Revision: 1.1 18/11/2010 07:36:45 PM
 * @noinspection DuplicateThrows
 */
public interface ValorConfiguradoDAO extends BaseDAO
{

    /**
     * Guarda un {@link ValorConfigurado} en persistencia.
     * Este {@link ValorConfigurado} no debe existir en persistencia o una
     * AlreadyPersistedObjectException debe brotar.
     *
     * @param o                   ValorConfiguradoK a persistir.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return ValorConfiguradoK despu&eacute;s de persistirse.
     *         <p/>
     *         Una AlreadyPersistedObjectException surgir&aacute;
     *         en caso de que este {@link ValorConfigurado} ya existiera en persistencia.
     *
     * @throws com.psiqueware.alheli.dao.DAOException
     *          en caso de un error de persistencia.
     */
    ValorConfigurado saveValorConfigurado(final ValorConfigurado o, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Actualiza un {@link ValorConfigurado} en persistencia
     *
     * @param o                   ValorConfigurado a actualizar
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link ValorConfigurado} actualizado
     *         <p/>
     *         Una NotAPersistedObjectException surgir&aacute;
     *         en caso de que este {@link ValorConfigurado} no existiera en persistencia.
     *
     * @throws com.psiqueware.alheli.dao.DAOException
     *          en caso de un error de persistencia.
     */
    ValorConfigurado updateValorConfigurado(final ValorConfigurado o, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Devuelve un {@link ValorConfigurado} a partir de su id.
     *
     * @param id                  del {@link ValorConfigurado} que se busca
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link ValorConfigurado} en caso de encontrarlo, <code>null</code> en otro caso.
     *
     * @throws com.psiqueware.alheli.dao.DAOException
     *          si se presenta alg&uacute;n problema.
     */
    ValorConfigurado findValorConfiguradoPorId(final Long id, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Elimina un {@link ValorConfigurado} del sistema de persistencia.
     *
     * @param o                   ValorConfigurado que se pretende elimninar.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *                            <p/>
     *                            Una NotAPersistedObjectException surgir&aacute; si dicho objeto no exist&iacute;a en persistencia.
     *
     * @throws com.psiqueware.alheli.dao.DAOException
     *          si no se puede comunicar a la base de datos.
     */
    void deleteValorConfigurado(final ValorConfigurado o, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Devuelve un listado de los {@link ValorConfigurado} que se encuentran en persistencia.
     *
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return List de {@link ValorConfigurado} en caso de encontrarlo, una lista vacia en caso contrario.
     *
     * @throws com.psiqueware.alheli.dao.DAOException
     *          si se presenta alg&uacute;n problema.
     */
    List<ValorConfigurado> listValorConfigurado(final EnlaceTransaccional enlaceTransaccional) throws DAOException;


    /**
     * Busca el {@link ValorConfigurado}. Lo obtienes a partir del identificador &uacute;nico del
     * {@link Dominio} al que pertenece su contexto y nombre.
     *
     * @param idDominio           identificador &uacute;nico del {@link Dominio} al que pertenece el {@link ValorConfigurado}.
     * @param contexto            al que pertenece el {@link ValorConfigurado}.
     * @param nombre              al que pertenece el {@link ValorConfigurado}.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link ValorConfigurado} en caso de encontrarlo, <code>null</code> en otro caso.
     *
     * @throws com.psiqueware.alheli.dao.DAOException
     *          si se presenta alg&uacute;n problema.
     */
    ValorConfigurado findValorConfiguradoPorIdDominioContextoNombre(final Long idDominio, final String contexto, final String nombre, final EnlaceTransaccional enlaceTransaccional) throws DAOException;
}
